home *** CD-ROM | disk | FTP | other *** search
/ Netware Super Library / Netware Super Library.iso / acss_com / stpe301 / stompere.doc < prev    next >
Text File  |  1995-07-05  |  43KB  |  1,258 lines
  1.  
  2.  
  3.                                  Stomper  3.0
  4.                        
  5.                        
  6.                        
  7.                        
  8.  
  9.                        
  10.                   Modemsharing-Software for Novell or Netbios
  11.                                 based networks
  12.                        
  13.                        
  14.                        
  15.                                  DOS/Windows
  16.                        
  17.                        
  18.                        
  19.                        
  20.                        
  21.                       (C) 1994,1995 Pflug Datentechnik.
  22.                        
  23.  
  24.  
  25. Hardware and software requirements for
  26. installation:
  27.  
  28. -   network, preferably Personal NetWare,
  29.     Novell NetWare lite, NetWare >=3.11 or
  30.     Netbios network (Lantastic)
  31. -   minimum DOS 3.3
  32. -   Windows 3.1 if available
  33. -   1 serial interface per modem server, if
  34.     possible FIFO buffered (UART 16550)
  35. -   Processor depending on number of modem
  36.     servers on one computer, minimum AT
  37.     (80286)
  38.  
  39.  
  40. 1 The Concept
  41. 1.1 What is a modem-/ISDN-server?
  42. 1.2 Server-Client Operation
  43. 2 Installation
  44. 2.1 fast installation
  45. 2.2 Complete Installation
  46.  2.2.1 The Queuemanager
  47.  2.2.2 The modem server
  48.  2.2.3 The Client
  49.  2.2.4 Windows-Modemsharing
  50.  2.2.5 The ISDN server
  51.  2.2.6 The ISDN-client
  52. 3 Select Specific Modemservers By Different Ports
  53. 4 the Cooperative Mode
  54. 5 Queue Management
  55. 6 The Monitor
  56. 7 Programs Using INT 14 (BIOS)
  57. 8 Stomper And Windows For Workgroups / Windows 95
  58. 8.1 Microsoft Network
  59. 8.2 Novell Network
  60. 9 Installation On A Netware Fileserver (NLM-Version)
  61. 10 Applying Access Rights
  62. Appendix A Suitable Programs
  63. Appendix B NETINFO.EXE
  64. Appendix C Tips
  65.  1. Telemate
  66.  2. Terminate
  67.  3. Telix For Windows
  68.  4. pcAnywhere
  69. Appendix D Troubleshooting
  70. Appendix E What is a FOSSIL driver?
  71. Appendix F What is a network fossil driver?
  72. Appendix G How to order
  73. Appendix H Support
  74.  
  75.  
  76.  
  77.  
  78. 1   The Concept
  79. ~~~~~~~~~~~~~~~
  80.  
  81. 1.1 What is a modem-/ISDN-server?
  82. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  83.  
  84. The modemserver is a small program, that accesses the device directly, that
  85. should be made available throughout the network.
  86. There may be more than one modemserver (or ISDN-server) on one computer
  87. oder there may be several servers spread over the whole network.
  88. When a client accesses a modemserver, all communication between
  89. communication software (terminal, fax, ...) and the modem is directed
  90. through the network.
  91. Stomper is responsible for repacking the data suitable for the network, to
  92. send it and to convert it back. It appears to the user as if the modem was
  93. attached directly to his local workstation.
  94. Often the modemserver is compared to a printerserver. This is not quite
  95. correct. The main difference is, that the printer server is "batch-driven".
  96. This means, that a print job is placed into a temporary file, which is
  97. read by the printer server whenever it is ready and the contents then are
  98. sent to the printer.
  99. A modemserver works online. All data is sent to the device immediately.
  100. Additionally all line-control information is passed on.
  101.  
  102.  
  103.  
  104.  
  105. 1.2 Server-Client Operation
  106. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  107.  
  108. As soon as a client requests an available modem or an ISDN-adapter (this
  109. happens automatically, when your communications software is started),
  110. the client-program (NETFOS, NFCAPI, ...) searches for a modemserver and
  111. initiates a session.
  112. From this moment on, the server is not available for other stations. It is
  113. reserved for this one client.
  114. At the end of the session, the server will get released.
  115.  
  116.  
  117.  
  118. 2   Installation
  119. ~~~~~~~~~~~~~~~~
  120.  
  121. 2.1 fast installation
  122. ~~~~~~~~~~~~~~~~~~~~~
  123.  
  124.  
  125. First of all, the queue manager
  126.  
  127.     STMGR
  128.  
  129. is loaded on any available workstation in the network. This could be a
  130. computer not integrated in the modem sharing, or a modem server.
  131. If you intend to run Stomper in a Novell Netware 3.11 or higher network, we
  132. strongly recommend to install STMGR.NLM on the fileserver rather than
  133. installing the queuemanager on a DOS station. Refer to chapter Installation
  134. on a NetWare fileserver (NLM-version) on page 28.
  135. Please read chapter 4, waiting queue administration, in this context.
  136.  
  137.  
  138. 1.  Modemsharing
  139. ~~~~~~~~~~~~~~~~
  140.  
  141.      To install a modemserver, load
  142.  
  143.           STOMPER /Px    (x = number of the port ; 1 = COM1)
  144.  
  145.      To install a modem client, load:
  146.  
  147.           NETFOS /Px     (x = number of the port)
  148.  
  149.           NETFOS now serves all applications, that use a FOSSIL
  150.           driver. For BIOS-INT14 or Windows-COMM.DRV,
  151.           read the next chapter.
  152.  
  153. 2. ISDN-Sharing
  154. ~~~~~~~~~~~~~~~
  155.  
  156. To install an ISDN-server, load:
  157.  
  158.     STISDN
  159.  
  160. To install an ISDN-client, load:
  161.  
  162.     NFCAPI
  163.  
  164. Now your ISDN-applications can access NFCAPI(CAPI v1.1)
  165.  
  166.  
  167.  
  168. 2.2 Complete Installation
  169. ~~~~~~~~~~~~~~~~~~~~~~~~~
  170.  
  171. Stomper either works with the IPX- or the Netbios protocol. In Novell
  172. networks IPX is loaded already, so nothing else has to be done.
  173. Others (for example Lantastic: AILANBIO), however, require the installation
  174. of the Netbios driver. Most network types (NetWare/NetWare Lite,
  175. Lantastic...) supply Netbios. With the use of Netbios Stomper becomes
  176. independent of the available network.
  177.  
  178.  
  179.  
  180. 2.2.1    The Queuemanager
  181. ~~~~~~~~~~~~~~~~~~~~~~~~~
  182.  
  183. The Queuemanager performs the following tasks:
  184.  
  185. 1.  "Tracker", observes the status of all modem servers installed in the
  186.     network, containing the following information: Status of the modem
  187.     server (busy/free), the Client (Netfos) which is presently served,
  188.     number of bytes transmitted in a session.
  189.     This information is analysed and displayed for example by STMON, the
  190.     monitor program.
  191.  
  192. 2.  "Queue manager", allocates free modem servers to the clients. In order
  193.     to avoid chaos, the queue manager can only exist once in the network.
  194.     When STMGR is loaded for a second time in the network, only the tracker
  195.     part will be loaded automatically.
  196.  
  197. 3.  IPX routing. The transmitter must always know the destination network in
  198.     order to transport IPX packets over several network segments. STMGR
  199.     therefore gives his address to all routers in the network (the file
  200.     server can also work as a router and therefore adds this address to its
  201.     bindary). Stomper identifies this address by ordering it form the nearest
  202.     router. When the queue manager allocates a modem server to a client, the
  203.     network address of stomper is supplied to the client.
  204.  
  205. 4.  Logging. If the option /L is specified, a log file will be generated,
  206.     that logs all actions.
  207.  
  208. 5.  Stationrestrictions (only STMGR.NLM) See Chapter Applying access rights.
  209.  
  210.  
  211.  
  212. Command line parameters
  213.  
  214. If you intend to run Stomper in a Novell Netware 3.11 or higher network, we
  215. strongly recommend to install STMGR.NLM on the fileserver rather than
  216. installing the queuemanager on a DOS station. Refer to chapter Installation
  217. on a NetWare fileserver (NLM-version) on page 28.
  218.  
  219.  
  220.     STMGR [/F] [/U] [/L.....] [/A]
  221.  
  222.     /U   is given to remove an installed STMGR from the memory
  223.  
  224.     /F   the queue manager uses netbios, even if IPX is loaded
  225.  
  226.     /L  generates a logfile.
  227.         examples:
  228.  
  229.         STMGR /LSTOMPER.LOG       generates STOMPER.LOG in the directory, in
  230.                                   which STMGR.COM resides.
  231.  
  232.         STMGR /LC:\TEMP\ST.LOG    generates C:\TEMP\ST.LOG
  233.  
  234.     /A  Allow "autoattach". See also: NETFOS /A
  235.  
  236. please note, that if you wish to create a logfile in a desired directory,
  237. you must specify a complete path!
  238.  
  239.  
  240.  
  241. 2.2.2    The modem server
  242. ~~~~~~~~~~~~~~~~~~~~~~~~~
  243.  
  244. The modemserver accesses the modem (or another device connected to the
  245. RS-232-port).
  246. Apart from the application data, the line-condition will be updated whenever
  247. necessary. This condition includes DCD (Data Carrier Detect), DTR (Data
  248. Terminal Ready), RI (Ring Indicator), DSR (Data Set Ready), RTS (Ready To
  249. Send) and CTS (Clear To Send).
  250.  
  251. For DOS there are 2 variants of the modemserver:
  252.  
  253. ·   STOMPER.COM              accesses the serial port directly
  254. ·   STOMPERF.COM             uses a FOSSIL driver to communicate with the
  255.                              hardware
  256.  
  257. Using the latter, makes it possible to share any communications-hardware in
  258. the network, as long as there is an apropriate FOSSIL driver available
  259. (like CFOS for ISDN).
  260.  
  261.  
  262. For information on how to install a modemserver on a NetWare fileserver,
  263. refer to chapter Installation on a NetWare fileserver (NLM-version)
  264.  
  265.  
  266. Command line parameters
  267.  
  268.  
  269. STOMPER [/Px] [/Na] [/Lxxxxxx] [/U] [/F] [/Qxx] [/Bxxxx] [/Caaa...] [/R]
  270.  
  271. The parameters are optional:
  272.  
  273.     /P   selects the COM port for the modem,
  274.          for example /P2 for COM2. If omitted,
  275.          COM1 is selected automatically.
  276.  
  277.     /U   is given to remove any already
  278.          installed STOMPER from the memory.
  279.          This is only possible while Stomper
  280.          is not active.
  281.  
  282.     /F   STOMPER is told to use Netbios
  283.          exclusively (even if IPX is loaded)
  284.  
  285.     /Q   for unconventional IRQs. /Q7 => IRQ7
  286.  
  287.     /B   for unconventional ports. /B3E8  =>
  288.          Port 3E8
  289.  
  290.     /C   Cooperative mode: see chapter 3,
  291.          Cooperative mode
  292.  
  293.     /L   Lock Baud. Independent of the bps
  294.          rate chosen by the application
  295.          (terminal program,...), Stomper
  296.          always selects automatically the bps
  297.          rate of this parameter, for example
  298.  
  299.          /L57600 (locked).
  300.  
  301.          Attention: Windows applications
  302.          ignore this parameter!
  303.  
  304.     /N   one single character is added to this
  305.          option (for example one letter or one
  306.          digit), giving the modem server an
  307.          individual identification. Each modem
  308.          server has to be identified
  309.          individually (several modem servers
  310.          on one computer have individual
  311.          characters).
  312.  
  313.     /R   ensures RTS/CTS data flow control.
  314.          This is very helpful, for example if
  315.          you encounter problems when sending
  316.          with Winfax. Normally this option
  317.          does not influence any other
  318.          applications.
  319.  
  320.     /Z   16550 FIFO buffer control
  321.                 /Z0 FIFO off
  322.                 /Z1 FIFO on 1 byte threshold
  323.                 /Z4 FIFO on 4 byte threshold
  324.                 /Z8 FIFO on 8 byte threshold (default)
  325.                 /Z14FIFO on 14 byte threshold
  326.  
  327. It is not recommended to use this parameter!
  328. Stomper normally selects an 8 byte threshold for the FIFO buffer, which
  329. causes the least potential errors.
  330. On very slow PCs (286 - 6 MHz), it may be necessary to use /Z1.
  331.  
  332.  
  333.  
  334. 2.2.3    The Client
  335. ~~~~~~~~~~~~~~~~~~~
  336.  
  337. The modem client provides access to a modemserver. All applications that
  338. can use a FOSSIL driver or BIOS-INT14 (option /I) can use it to access a
  339. network modem.
  340.  
  341. Command line parameters
  342.  
  343.  
  344. NETFOS [/Px] [/U] [/I] [/F] [/Naaa...] [/A|/A+]
  345.  
  346.     /P   specifies which COM port will be
  347.          redirected, for example. /P2 for
  348.          COM2. COM1 is chosen automatically
  349.          when this parameter is not used.
  350.  
  351.     /U   is given to remove an installed
  352.          NETFOS from the memory.
  353.  
  354.     /I   This parameter is necessary to
  355.          redirect programs which communicate
  356.          using the BIOS-INT-14. With this
  357.          parameter given, Netfos finds out if
  358.          an application is able to serve a
  359.          fossil interface, and reacts
  360.          accordingly.
  361.  
  362.          Without this parameter Netfos can
  363.          only serve Windows programs or
  364.          programs which support a fossil
  365.          driver.
  366.  
  367.     /F   Netfos uses Netbios (even if IPX is
  368.          loaded)
  369.  
  370.     /N   All modem servers wanted in the
  371.          network are listed here. When for
  372.          example. /N123 is given, the
  373.          queuemanager selects the first
  374.          available modem server from the list.
  375.          The priority is from left to right,
  376.          so that the queuemanager selects
  377.          STOMPER /N2 when STOMPER /N1 is
  378.          occupied.
  379.          This option is invalid (and
  380.          meaningless) In the 1-server version.
  381.  
  382.     /A   "Autoattach"-mode. When a modemserver
  383.          is assigned to a user after he was
  384.          placed in the queue (waiting for a
  385.          modemserver to become available),
  386.          this option suppresses the message
  387.          "Connected to modemserver". So the
  388.          connection will be established
  389.          without interaction. For both /A and
  390.          /A+ STMGR must have been loaded with
  391.          the option /A as well!
  392.  
  393.     /A+  Same as /A, but additionally the user
  394.          will be placed into the waitingqueue
  395.          automatically, in case there is no
  396.          modemserver available. This mode runs
  397.          completely unattended.
  398.  
  399. Note that the parameter /Px does not have to be identical for the two
  400. drivers. For Stomper /Px defines the interface which is physically connected
  401. with the modem. For Netfos /Px defines only the interface which is addressed
  402. by the terminal program.
  403.  
  404.  
  405.  
  406. 2.2.4    Windows-Modemsharing
  407. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  408.  
  409. In the file SYSTEM.INI (Windows directory) change the following line in
  410. the [boot]-section:
  411.  
  412. comm.drv=comm.drv
  413.  
  414. change into
  415.  
  416. comm.drv=stcomm.drv
  417.  
  418. Make sure that there is only one line of comm.drv=...!!
  419.  
  420. Attention!
  421. After Winfax installations comm.drv is usually changed into wfxcomm.drv.
  422. This can be replaced without problems.
  423.  
  424. STCOMM.DRV  should be placed on a DOS path or in a windows directory.
  425. Alternatively, the whole path can be given.
  426.  
  427.  
  428.  
  429. 2.2.5 The ISDN server
  430. ~~~~~~~~~~~~~~~~~~~~~
  431.  
  432. The ISDN server (STISDN) makes a CAPI accessible by the clients (NFCAPI).
  433. An STISDN can only serve one client at a time. To let more than one client
  434. access the CAPI at the same time, STISDN has to be loaded multiple times.
  435. These can use the same CAPI, depending on how many applications this CAPI
  436. can support (usually 2 to 4).
  437.  
  438. Command line parameters
  439.  
  440.  
  441. STISDN [/Na] [/U] [/F] [/M...]
  442.  
  443.  
  444.     /U   is given to remove any already
  445.          installed STISDN from the memory.
  446.          This is only possible while STISDN is
  447.          not active.
  448.  
  449.     /F   STISDN is told to use Netbios
  450.          exclusively (even if IPX is loaded)
  451.  
  452.     /N   one single character is added to this
  453.          option (for example one letter or one
  454.          digit), giving the modem server an
  455.          individual identification. Each ISDN
  456.          server has to be identified
  457.          individually (several ISDN servers on
  458.          one computer have individual
  459.          characters).
  460.  
  461.     /M...    defines, how much memory is
  462.              reserved for communications. The
  463.              default is 16384 Bytes. Values from
  464.              4000-65500 Bytes are accepted.
  465.              The optimum depends on the software
  466.              you will be using and the number of
  467.              concurrent ISDN-connections. The
  468.              default value usually is enough for 1
  469.              application with channel-bundeling or
  470.              two concurrent applications using
  471.              each a single ISDN-connection.
  472.  
  473.  
  474. 2.2.6  The ISDN-client
  475. ~~~~~~~~~~~~~~~~~~~~~~
  476.  
  477. The ISDN cclient (NFCAPI) provides applications with a virtual CAPI v1.1-
  478. interface. Up to 4 applications can be serviced by the same NFCAPI.
  479.  
  480.  
  481. Command line parameters
  482.  
  483.  
  484. NFCAPI [/U] [/F] [/Naaa...] [/A|/A+]
  485.  
  486.     /U   is given to remove an installed
  487.          NFCAPI from the memory.
  488.  
  489.     /F   NFCAPI uses Netbios (even if IPX is
  490.          loaded)
  491.  
  492.     /N   All ISDN servers wanted in the
  493.          network are listed here. When for
  494.          example, /N123 is given, the
  495.          queuemanager selects the first
  496.          available ISDN server from the list.
  497.          The priority is from left to right,
  498.          so that the queuemanager selects
  499.          STISDN /N2 when STISDN /N1 is
  500.          occupied.
  501.          This option is invalid (and
  502.          meaningless) In the 1-server version.
  503.  
  504.     /A  "Autoattach"-mode. When a ISDN server
  505.          is assigned to a user after he was
  506.          placed in the queue (waiting for a
  507.          ISDN server to become available),
  508.          this option suppresses the message
  509.          "Connected to ISDN server". So the
  510.          connection will be established
  511.          without interaction. For both /A and
  512.          /A+ STMGR must have been loaded with
  513.          the option /A as well!
  514.  
  515.     /A+  Same as /A, but additionally the user
  516.          will be placed into the waitingqueue
  517.          automatically, in case there is no
  518.          ISDN server available. This mode runs
  519.          completely unattended.
  520.  
  521.  
  522. 3   Select specific modemservers by different ports
  523. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  524.  
  525. Example:
  526.  
  527. You have 5 modem-/ISDN-servers installed in your network:
  528.  
  529. ·   three modems with IDs 1, 2 and 3
  530. ·   two ISDN-lines with IDs 4 and 5
  531.  
  532. Of course you will want to use an ISDN-line, when you need an ISDN-line
  533. and a modem line, when you need a modem line. You can do this by simply
  534. entering the following command line:
  535.  
  536. NETFOS /P1(123) /P2(45)
  537.  
  538. When your Application addresses COM1, you will get connected to
  539. modemserver 1, 2 or 3, whichever is available. When your application uses
  540. COM2, one of th ISDN lines will be selected.
  541.  
  542. Note that there is no option /N specified, since this is completely replaced
  543. by the values in brackets. You can specify up to 4 ports.
  544.  
  545. Of course you can use this method to distinguish different modemtypes as
  546. well - ISDN was chosen as a typical example of different transport media.
  547.  
  548.  
  549.  
  550. 4   The Cooperative Mode
  551. ~~~~~~~~~~~~~~~~~~~~~~~~
  552.  
  553.  
  554. This mode - under certain circumstances - enables the use of another
  555. software (for example a mailbox) on the modem server - sharing the port
  556. cooperatively with Stomper.
  557.  
  558. Parameter: /Cxxxxx
  559.  
  560. xxxxx stands for any modem command. At the end of a session this command is
  561. sent to the modem in order to re-initialize it. CR/LF is added to this
  562. string (for example. ATZ), automatically.
  563.  
  564. Thus the modem server can run a mailbox, which will be stopped automatically
  565. when a client in the network demands the modem. While a caller is logged
  566. into the mailbox, Stomper is inactive.
  567.  
  568. In order to avoid fatal failures on the computer, please read the following
  569. lines even if this sounds a bit technical:
  570.  
  571. For safety reasons a network-modem demand is rejected, when the CD signal
  572. is active, for example, when someone is logged into the mailbox. Stomper
  573. will also be blocked for another 60 seconds after the last ring.
  574. This mode has to be handled with care, as it is quite rude to block an
  575. application just like that, but this can be done for example with FrontDoor
  576. and Remote Access.
  577.  
  578. As during the blocking of the modem the bps-rate could be changed, at the
  579. end of such a session Stomper sends an optional command (see above, "/Caaa")
  580. to the modem in order to set the correct bps rate. For this, the modem must
  581. have an automatic baudrate identification.
  582.  
  583. In the cooperative mode Stomper MUST NOT BE LOADED in the high memory
  584. area(UMB), due to the following:
  585.  
  586. The computer will be stopped at an appropriate time, that is in the moment
  587. of a timer interrupt (produced by the computer 18 times per second).
  588.  
  589. "Appropriate" means:
  590.  
  591. 1.  there is no hard disk or disk access
  592. 2.  Windows is inactive
  593. 3.  The program interrupted is placed in the memory above stomper and
  594.     under the high memory area from A000:0000 on.
  595.  
  596. No. 3 ensures that no IPX routine has been interrupted.
  597. As Stomper depends on IPX, it would not dare to touch this without being
  598. affected personally. As Stomper needs the IPX (or Netbios) drivers, they
  599. are normally placed in a lower memory section or in an UMB. But if Stomper
  600. has also been loaded in the high memory area, there is no certainty where
  601. the network drivers are placed related to Stomper.
  602.  
  603. It is possible that the interrupt does not appear. This happens for example.
  604. when the command line in DOS is used, which is mainly executed in
  605. COMMAND.COM (below Stomper) or in BIOS (>A000). The use of the interface is
  606. not affected in this case.
  607.  
  608.  
  609.  
  610.  
  611.  
  612. 5   Queue Management
  613. ~~~~~~~~~~~~~~~~~~~~
  614.  
  615.  
  616. In order to enable a precise access to one or several modem servers in the
  617. network, the program
  618.  
  619. STMGR.COM
  620.  
  621. has to be loaded on one computer (any) in the network. STMGR.COM should
  622. already be active in the network, before a Client (Netfos) or modem server
  623. (Stomper) is loaded. Preferably this program should be installed on a
  624. modem server. If you are working with Novell Netware, the best choice will
  625. be the Fileserver (STMGR.NLM)
  626.  
  627. This program operates completely in the background and does not require
  628. much memory.
  629.  
  630.  
  631. The queue manager's strategies
  632.  
  633. When a client demands a modem server, the queue manager tries to allocate
  634. a free modem server which is selected by NETFOS /Naaa...(from left to right).
  635. In case all modem servers are busy, the client computer receives the
  636. following message:
  637.  
  638. No modemserver available. Queue in?       Y/N
  639.  
  640. After confirming Y, the following message appears:
  641.  
  642. Queued in. Wait in foreground?         Y/N
  643.  
  644. Now there are two possibilities:
  645.  
  646. 1.  "Wait in the background" (N) tells the application that no fossil
  647.     driver is installed (not recommended for pure BIOS INT14 applications).
  648.     The computer can be used and as soon as a modem server is free, the
  649.     following message appears:
  650.  
  651.     Connected to modem server    (ENTER)
  652.  
  653. The queue manager marks the modem server as "reserved". The user has
  654. 1,5 minutes to start his application and to use the modem server.
  655.  
  656.  
  657. 2.  While waiting in the foreground, the following message appears
  658.  
  659.     Waiting for modem server...    (ESC)
  660.  
  661.     In the meantime the computer cannot be used for other applications.
  662.  
  663. Under windows this process is executed accordingly, but only the
  664. application in use is paused.
  665.  
  666.  
  667.  
  668.  
  669.  
  670. 6   The Monitor
  671. ~~~~~~~~~~~~~~~
  672.  
  673. The monitor (STMON.EXE) provides an overview over the modem servers
  674. installed in the network and the proceedings can be observed. The monitor is
  675. started by loading
  676.  
  677. STMON
  678.  
  679. As STMON displays the information obtained from the tracker, it depends on
  680. STMGR.COM being loaded. If STMGR is not already in memory, the monitor will
  681. load it automatically. For this, however, STMGR.COM must be either
  682.  
  683.     -   in the same directory as STMON.EXE or
  684.     -   in the DOS path.
  685.  
  686. Attention: The monitor must not be started in a DOS box under windows!
  687.  
  688. The monitor displays ten sections on the screen, each containing information
  689. of an individual modem server.
  690.  
  691. Field identifications:
  692.  
  693. -   Network address - individual address in the network which is preset by
  694.     the network adaptor. In order to obtain a better overview, a file called
  695.  
  696.     NODES.LST
  697.  
  698.     can be created, in which names are allocated to the network addresses.
  699.     An example for such a file:
  700.  
  701.     924e32a  John's abacus
  702.     80ca23e5 venus
  703.  
  704.     ... allocating the names "John's abacus" and "venus" to the according
  705.     network addresses. John's abacus and venus will replace the cryptic
  706.     address names on the monitor.
  707.  
  708. -   Served interface - the serial interface served by the modem server
  709.     or CAPI
  710.  
  711. -   Status - status of the modem server.
  712.     Possible states:
  713.  
  714.     - free           the modem server is available at the moment
  715.     - Ser. <Client>  the modem server is just serving the client named
  716.                      <Client>
  717.     - Res. <Client>  the modem server is presently reserved for the client
  718.                      <Client>.
  719.     - locally in use The modem server is presently used locally in the /"C"
  720.                      mode         (for example a user in the mailbox)
  721.  
  722. -   Sent / received bytes - number of bytes transmitted in the current
  723.     session. This information will be held until the start of a new session.
  724.  
  725. -   Identification - the identification of the modem server (/Na).
  726.  
  727.  
  728.  
  729.  
  730. 7   Programs Using INT 14 (BIOS)
  731. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  732.  
  733.  
  734. The fossil driver is to be understood as an extension to the BIOS-INT 14
  735. interrupt. However, Stomper expects that the software used initializes the
  736. fossil driver (not necessary with BIOS routines).
  737. For programs only using BIOS-INT 14, NETFOS has to be loaded with the
  738. parameter /I.
  739. With pure INT 14 applications, Stomper always switches to RTS/CTS data flow
  740. control.
  741.  
  742. Approximately 20 seconds after the end of an "INT-14 program" the modem
  743. server becomes available for others again.
  744.  
  745. When using fax software, which communicates via INT 14, it is absolutely
  746. necessary to lock Stomper on an appropriate rate. The ideal bps rate depends
  747. on the modem used.
  748. Standard modems transmit faxes with a rate of up to 14400 bps, or 19200 bps
  749. on the phone line. In this case the bps rate has to be locked on 19200 bps.
  750. Most modems accept a higher rate, for example 57600 bps, when transmitting
  751. faxes.
  752.  
  753. For modems with a maximum baud rate of 9600 bps, Stomper should be locked
  754. on 9600 bps (see parameter /L on page 6).
  755.  
  756.  
  757.  
  758. 8   Stomper and Windows for Workgroups / Windows 95
  759. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  760.  
  761. WfW and Windows 95 normally load their own network drivers. This means, in
  762. these cases, there are no network protocols available prior to loading
  763. Windows.
  764. In case you are running Netware or any network with DOS-drivers, you can
  765. skip this chapter.
  766.  
  767. Create the file WINSTART.BAT in your Windows-directory, like
  768.  
  769. -----------------------------------
  770. NETFOS /P1
  771. -----------------------------------
  772.  
  773. The batchfile WINSTART.BAT will be executed by Windows after all
  774. system-drivers have been loaded (including network drivers).
  775.  
  776. STCOMM.DRV should be loaded as described in chapter "Complete Installation"
  777.  
  778. Be aware that this version of Stomper only supports 16-bit applications!
  779. New 32-bit software uses a different driver.
  780.  
  781.  
  782. 8.1 Microsoft Network
  783. ~~~~~~~~~~~~~~~~~~~~~
  784.  
  785. Make the following changes to your Windows network setup:
  786.  
  787. Defaultprotocol:   NetBEUI
  788.  
  789. NCBS=255
  790.  
  791. NetHeapSize=20
  792.  
  793.  
  794. 8.2 Novell Network
  795. ~~~~~~~~~~~~~~~~~~
  796.  
  797. Make the following changes to your Windows network setup:
  798.  
  799. Defaultprotocol:   IPX/SPX
  800.  
  801. SPX Connections = 60
  802.  
  803.  
  804.  
  805. 9   Installation on a NetWare fileserver (NLM-version)
  806. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  807.  
  808.  
  809. Copy STMGR.NLM and STOMPER.NLM to the SYS:SYSTEM directory.
  810.  
  811. To install STMGR.NLM on the fileserver, enter
  812.  
  813. load STMGR
  814.  
  815. at the console.
  816.  
  817. To install a modemserver, you will need to install an asynchonous
  818. I/O-driver first. This requires the module AIO.NLM and any AIO-driver.
  819. The appropriate AIO-driver for standard RS232 is AIOCOMX.NLM. You can
  820. download AIO-drivers from Compuserve NOVLIB or from our BBS. Several
  821. AIO drivers for Hostess, Digiboard, etc. are available.
  822.  
  823. For available commandline options recognized by STOMPER.NLM and STMGR.NLM,
  824. refer to chapter Complete Installation on page 6.
  825.  
  826. Note the different format of STOMPER-option /P for port selection:
  827.  
  828. /P<hardwaretype>,<boardnumber>,<portnumber>
  829.  
  830. The three values are shown when you load the AIO-driver. If you are not
  831. sure what to type, you can load STOMPER.NLM without the /P-option.
  832. Stomper will let you select the desired port and then display the
  833. appropriate commandline you should use in future.
  834.  
  835. If you posess a multi-modemserver version of Stomper, you can load
  836. STOMPER.NLM multiple times.
  837.  
  838. If you type
  839.  
  840. unload stomper
  841.  
  842. at the system console, you will disable all running modemservers.
  843.  
  844. Caution!!
  845.  
  846. -   There is a bug in the Netware 3.x / 4.x -
  847.     SPX-protocol. This bug known to STOMPER.NLM and
  848.     Stomper tries hard to avoid problems that might
  849.     arise.
  850.     But wo do strongly advise you to install the
  851.     following Novell-patches:
  852.  
  853.     PATCHMAN.NLM
  854.     SPXDDFIX.NLM
  855.     SPXFIX2.NLM
  856.  
  857.     These three modules are contained in the
  858.     archive STRTL3.EXE, that can be downloaded free
  859.     from Compuserve NOVLIB or from our support BBS.
  860.  
  861. -   If you have problems loading AIO.NLM,
  862.     STOMPER.NLM and STMGR.NLM, and you get a
  863.     message like
  864.  
  865.     "Public symbol IsColorMonitor not found",
  866.  
  867.     then you have an old version of CLIB.NLM
  868.     (Netware 3.11). Just install an updated
  869.     version, that is part of the archive
  870.     LIBUP4.EXE (Compuserve NOVLIB or our support
  871.     BBS)
  872.  
  873. -   When loading AIOCOMX, do not use the
  874.     option "node=..." if possible
  875.  
  876. -   You should use AIOCOMX >= 2.11. It should
  877.     be loaded with the maxrate-option:
  878.  
  879.     load aiocomx [...] maxrate=115200
  880.  
  881. -   The use of a FIFO (16550)-serial UART is
  882.     strongly recommended.
  883.  
  884.  
  885.  
  886. 10  Applying access rights
  887. ~~~~~~~~~~~~~~~~~~~~~~~~~~
  888.  
  889. STMGR.NLM provides a mechanism to refuse access to all or specific
  890. modemservers by username, stationaddress and/or network.
  891.  
  892. This mechanism is activated, as soon as STMGR.NLM finds a file named
  893. QMREST.LST in the same directory, STMGR.NLM is contained in. If this file
  894. is not present, no restrictions apply.
  895.  
  896. This file could look like this:
  897.  
  898.  
  899.              [stations]
  900.              928485
  901.              80A23E42     12Q
  902.  
  903.              [nets]
  904.              1000002
  905.              1000003       1
  906.  
  907.              [names]
  908.              supervisor
  909.              Peter         24
  910.  
  911.  
  912. Rules:
  913.  
  914. -   there are 3 possible sections: [stations], [nets] and [names]
  915. -   you can omit particular sections. There will be no restrictions for
  916.     these sections.
  917. -   if a section is present, it defines  objects (stationaddresses,
  918.     usernames or networkaddresses), that have access to modemservers. All
  919.     objects of this sectiontype, that are not defined, will not have access
  920.     to any modemserver.
  921. -   if only the object is entered in a line, it receives access rights to
  922.     all modemservers throughout the network. If you additionally enter a
  923.     list of modemserver-ids - separated by spaces or tabs from the objects
  924.     designation - the object will only have access to the specified
  925.     modemservers.
  926. -   access rights are combined by logical and, which means, the user must
  927.     qualify by station, network and username (in case restrictions apply
  928.     respectively)
  929.  
  930. Typically the file QMREST.LST will only contain
  931. a [names] or [nets] section.
  932.  
  933.  
  934.  
  935. Appendix A    Suitable Programs
  936. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  937.  
  938.  
  939. All windows programs, using the functions (API) (provided by windows
  940. COMM.DRV) for the interface addressing, are supported.
  941.  
  942. DOS:
  943.  
  944. Not every terminal program supports a fossil driver. An example for a
  945. program with FOSSIL support is Telemate (In Options / Terminal, FOSSIL can
  946. be selected)
  947.  
  948. For the use of Telemate note the following: in order to work with the dial
  949. list, for each listing the fossil driver has to be selected individually.
  950. To select the fossil support in Telemate, first the baud rate has to be
  951. set to a maximum of 38400bps. Otherwise fossil will be ignored!
  952.  
  953. A short list of programs which have been tested with Stomper:
  954.  
  955. Name            Operating       Comments
  956.                 system
  957. ------------------------------------------------------------------
  958. Telemate        DOS             extensive and comfortable
  959.  
  960. FX-Term         DOS             Very easy to handle GUI, works with
  961.                                 RoboBoard.
  962.  
  963. Terminate       DOS             extensive (similar to Telemate). IEMSI
  964.                                 support
  965.  
  966. Dos/CIS         DOS             Compuserve information manager
  967.  
  968. Terminal        Windows         Terminal program included in windows packet
  969.  
  970. GoCIS           Windows         Offline Compuserve navigator
  971.  
  972. NavCIS          Windows         Offline Compuserve navigator
  973.  
  974. WinCIS          Windows         Compuserve information manager
  975.  
  976. PowerCom        Windows         terminal program
  977.  
  978. Telix for       Windows         extensive and comfortable terminal program
  979. Windows
  980.  
  981. Transend        DOS/Windows     terminal / fax
  982.  
  983. RemoteAccess    DOS             BBS software
  984.  
  985. Frontdoor       DOS             Fido mailer
  986.  
  987. Binkley         DOS             Fido mailer
  988.  
  989. Crosspoint      DOS             Fido / Z net / UUCP - point system
  990.  
  991. Winfax          Windows         fax software
  992.  
  993. Bitfax          Windows         fax software
  994.  
  995. Unicom          Windows         comfortable terminal program
  996.  
  997.  
  998.  
  999. Most of these programs are available are available as shareware on our
  1000. Support BBS (see end of Document).
  1001.  
  1002.  
  1003.  
  1004.  
  1005. Appendix B    NETINFO.EXE
  1006. ~~~~~~~~~~~~~~~~~~~~~~~~~
  1007.  
  1008. This a small diagnostic tool added to the packet, giving some information of
  1009. the network environment (received from netbios), for example
  1010.  
  1011.  
  1012. Permanent name:                         0000C0039A79   ; network address
  1013. Jumper:                                 40
  1014. POST result:                            00 
  1015. Version:                                0.1
  1016. Minutes up:                             0
  1017. Number of CRC errors:                   0
  1018. Number of alignment errors:             0
  1019. Number of collisions:                   0
  1020. Number of aborts:                       1
  1021. Number of transmitted packets:          6
  1022. Number of received packets:             10
  1023. Number of retransmits:                  4
  1024. Number of out-of-buffer-counts:         0
  1025. Free NCBs:                              10
  1026. Max. NCBs:                              12
  1027. Active sessions:                        32
  1028. Max. packet size:                       1024
  1029. Names:                                  1
  1030. NFOSMPX1                                0
  1031.  
  1032.  
  1033. Attention! This tool can only be useful when Netbios is actually installed.
  1034. Otherwise no useful information will be displayed here! This information
  1035. is of no use for IPX.
  1036.  
  1037.  
  1038. Appendix C    Tips
  1039. ~~~~~~~~~~~~~~~~~~
  1040.  
  1041.  
  1042. 1.  Telemate
  1043. ~~~~~~~~~~~~
  1044.  
  1045. Before you select FOSSIL, be careful to set the speed to not more than
  1046. 38400 bps. Otherwise Telemate will reject the FOSSIL-Setting (without
  1047. displaying a message).
  1048. In case even this fails, the safest way is to edit TM.CFG manually. Just
  1049. change
  1050.  
  1051. Connection=Modem
  1052.  
  1053. to
  1054.  
  1055. Connection=Fossil
  1056.  
  1057. and make sure that the entry Port= is correct.
  1058.  
  1059. Also, FOSSIL has to be selected for every entry in the Dial-List.
  1060.  
  1061.  
  1062. 2.  Terminate
  1063. ~~~~~~~~~~~~~
  1064.  
  1065. The first time Terminate is set up for FOSSIL, it expects that a FOSSIL
  1066. driver is installed on COM1. This, of course, is not always given (e.g.
  1067. NETFOS installed on COM2).
  1068. The FOSSIL-support of Terminate is a little buggy here, and this may result
  1069. in a system-crash.
  1070.  
  1071. Workaround:
  1072.  
  1073. either use NETFOS on COM1 or
  1074.  
  1075. the first time, you switch Terminate to FOSSIL, do it with a regular FOSSIL
  1076. driver (like BNU or X00) installed. From then on you can use NETFOS.
  1077.  
  1078. If you don't have a FOSSIL driver handy, load
  1079.  
  1080. NETFOS /P1() /P2()
  1081.  
  1082. This installs NETFOS on both COM1 and COM2.
  1083.  
  1084.  
  1085. 3.  Telix For Windows
  1086. ~~~~~~~~~~~~~~~~~~~~~
  1087.  
  1088. Use the COM-Setting, not FOSSIL! In Windows it is always recommended to use
  1089. STCOMM whenever possible.
  1090. Apart from that, the FOSSIL support of early versions of TfW is buggy.
  1091.  
  1092.  
  1093. 4.  pcAnywhere
  1094. ~~~~~~~~~~~~~~
  1095.  
  1096. Use the plain INT14-Setting and do not set higher speeds than 9600 bps.
  1097. Otherwise pcAnywhere will not be able to initialize the port.
  1098. To achieve higher speeds, refer to the modemserver switch /L.
  1099.  
  1100. Appendix D    Troubleshooting
  1101. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1102.  
  1103. Problem              possible source             solution / remarks
  1104.  
  1105. The terminalprogram  The terminalprogram might   If provided by the terminal
  1106. doesn't react - no   address the hardware        software, switch to Fossil
  1107. characters are       directly                    or INT 14.
  1108. transmitted                                      In case the software doesn't
  1109.                                                  support a software inter-
  1110.                                                  face,
  1111.                                                  there is no way of
  1112.                                                  redirecting port usage.
  1113.  
  1114.                      The terminalprogram is set  Call NETFOS /I when using
  1115.                      to INT-14, but Netfos       BIOS-INT14-routines.
  1116.                      wasn't loaded with the /I-
  1117.                      option.
  1118.  
  1119.                      the wrong port is being     set the com-port settings of
  1120.                      addressed.                  the terminal software to the
  1121.                                                  value specified in the
  1122.                                                  commandline of Netfos.
  1123.  
  1124. Characters are lost  A non-buffered serial       Use a buffered serial device
  1125. during transmission  hardware is used            (UART 16550). Such can
  1126.                                                  be obtained for a small fee
  1127.                                                  in most computer stores.
  1128.                                                  Stomper relies on buffered
  1129.                                                  communications devices
  1130.                                                  more than other COM-
  1131.                                                  software, since it has to
  1132.                                                  deal with many interrupt
  1133.                                                  types at once (timer,
  1134.                                                  network and serial).
  1135.  
  1136.                      no handshaking active       Usually you have to specify
  1137.                                                  the type of handshaking you
  1138.                                                  want to use in the setup of
  1139.                                                  your communications
  1140.                                                  software. In most cases it's
  1141.                                                  best to set hardware
  1142.                                                  handshaking (RTS/CTS) to
  1143.                                                  on and software
  1144.                                                  handshaking (XON/XOFF) to
  1145.                                                  off.
  1146.  
  1147. Stomper hangs in     Stomper was loaded in       Stomper cannot be loaded in
  1148. cooperative mode     high memory                 high memory when driven in
  1149.                                                  cooperative mode.
  1150.  
  1151. It works with DOS    STCOMM.DRV wasn't           Make sure, the line
  1152. but not with Windows installed or wasn't         comm.drv=stcomm.drv is
  1153.                      installed correctly         placed in the [boot]-section
  1154.                                                  of you SYSTEM.INI-file and
  1155.                                                  that there is only one
  1156.                                                  occurence of a line
  1157.                                                  beginning with "comm.drv="
  1158.  
  1159. Fax-sending causes   You are using a DOS-Fax-    In this case, Stomper sets
  1160. problems             software that uses the      the handshake-method to
  1161.                      Bios-INT 14 interface.      "Hardware". Fax
  1162.                                                  transmission with class 2
  1163.                                                  expects software flow
  1164.                                                  control. make sure that your
  1165.                                                  modem is set to hardware
  1166.                                                  flowcontrol explicitly
  1167.  
  1168.  
  1169.                      XON/XOFF handshaking        start Stomper with the
  1170.                      doesn't function properly   commandline option /R
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176. Appendix E    What is a FOSSIL driver?
  1177. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1178.  
  1179. There are various possibilities for a DOS program to address serial
  1180. interfaces of a PC:
  1181.  
  1182. There is the hardware related method, communicating directly with the
  1183. interface components. This method is used very often because it's quick and
  1184. uncomplicated for the program user - no unnecessary thoughts about a
  1185. fossil driver and its implementation.
  1186.  
  1187. "Polite" programs use the 4 functions provided by the computer BIOS (INT 14):
  1188. Baud rate setting, character transmission, character receive and fetching
  1189. the interface status. This method has the advantage of being hardware
  1190. independent (only BIOS has to have the information how to communicate with
  1191. the hardware - the programmer isn't troubled with that). Big and decisive
  1192. disadvantage: under DOS, BIOS allows max. 9600 bps, which is out of date
  1193. today. Furthermore BIOS routines are generally quite slow.
  1194.  
  1195. Another possibility is the fossil driver, combining the advantages of the
  1196. solutions mentioned above - speed and hardware independence - troubling the
  1197. user with only one installation.
  1198.  
  1199. The fossil driver offers buffered interface communication as an additional
  1200. function to the BIOS, emulating the interface functions of BIOS. Data
  1201. arriving at the interface needn't be handled immediately by the software,
  1202. but are stored in a ring buffer. A program using BIOS for example, has to
  1203. handle every single character before the next arrives in order to avoid a
  1204. loss of data. With a fossil driver the data can be fetched and handled in
  1205. blocks.
  1206.  
  1207.  
  1208. Appendix F    What is a network fossil driver?
  1209. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1210.  
  1211.  
  1212. It's easy to exploit the advantage of a hardware independent program with
  1213. the use of a fossil driver. A suitable driver can pretend any digital
  1214. communication element against such a hardware independent program, for
  1215. example as COM2. The programm doesn't care how this works, as long as the
  1216. driver handles the mass of data.
  1217.  
  1218. Stomper uses this circumstance. A modem server is installed on a network
  1219. integrated computer linked to a modem. The modem server waits for a network
  1220. fossil driver connection, which again bluffs to be communicating with a
  1221. serial interface. At the same time a lot of instruction data and other data
  1222. are passed over the network, but don't worry, a normal network is hardly
  1223. concerned with that.
  1224.  
  1225.  
  1226. Appendix G - How to order
  1227. ~~~~~~~~~~~~~~~~~~~~~~~~~
  1228.  
  1229. We have registration sites in many countries. Run the program
  1230.  
  1231. ORDER.EXE
  1232.  
  1233. to get information on pricing and registration sites. You will be prompted
  1234. to select your country.
  1235.  
  1236.  
  1237.  
  1238. Appendix H    Support
  1239. ~~~~~~~~~~~~~~~~~~~~~
  1240.  
  1241.  
  1242. Pflug Datentechnik can be contacted via
  1243.  
  1244.  
  1245. Fax          49 / 7156 - 939005
  1246. e-mail       100340.1047@compuserve.com
  1247. Compuserve   Pflug 100340,1047
  1248. Fido         2:246/1009 (per Crashmail only, please!)
  1249.  
  1250. Mailbox  (see below)
  1251.  
  1252. Inquiries on the phone are not possible without prior consultation.
  1253.  
  1254. Current Stomper versions and several shareware/PD software can be
  1255. downloaded from our mailbox:
  1256.  
  1257. +49 / 7156 - 939006
  1258.